11 Debug Environment > 11.2 Emulator

11.2
The ME emulator is part of the SMTK and is used as the controlling entity for on-device debug­ging. Some values can be configured in the file wtk/bin/WM_Debug_config.ini (see below note for TC65). The emulator is running fine without changes in WM_Debug_config.ini file, because the settings for the serial interface (COM port and baudrate) are configured during installation of SMTK.
Note: For TC65 the file "WM_Debug_config.ini" is stored under the "Application Data" folder of the currently logged in user. Depending on the Windows operation system it can be found under the following directory:

Windows 2000:
e.g. "c:\Documents and Settings\<your login>\Application Data\
Siemens\SMTK\TC65_R3\WM_Debug_Config.ini"
Windows XP:
e.g. "c:\Documents and Settings\<your login>\Application Data\
Siemens\SMTK\TC65_R3\WM_Debug_Config.ini"
Windows Vista:
e.g. "c:\Users\<your login>\AppData\Roaming\
Siemens\SMTK\TC65_R3\WM_Debug_Config.ini"
In case the Application Data folder is not visible, it is possible to set the option to show hidden folders (choose Explorer menu Tool -> Folder option.. -> and select "show hidden folder").
Debugging information between the Debugger (IDE) and the JVM is transferred over an IP con­nection. In order to establish this IP connection between the PC and the module the emulator needs a special Dial-Up-Network (DUN):
•
•
•
•
Disable the Redial if line dropped option.
•
Enable Connect automatically
This Dial-Up Network (DUN) connection is installed automatically together with a standard modem or selecting USB modem during installation of SMTK. The emulator uses always the COM port or USB modem settings configured for this Dial-Up Network connection.
You can use any of the three serial interfaces (ASC0, ASC1, USB) to connect with module, but you will lose the functionality which is normally present on the interface. Because of this loss and because of its speed it is recommended that the USB interface be used.
Please keep in mind, that if you like to use a USB modem connection, you have to install and configure that modem connection before starting SMTK installation manually and select Sie­mens USB modem during SMTK installation. The Dial-up Network will be installed and config­ured with USB modem during SMTK installation. There are some points to notice in case of using the USB interface in a debugging session. If you are starting a debugging session very quickly once again after end of a previous debugging session, the emulator is not able to select the USB interface and is selecting a standard modem connection. Please wait some seconds to avoid this operation system dependent problem, because the Windows operation system needs some seconds to enable the USB port once again after the "IP connection for remote debugging" is closed.
If necessary, the IP addresses used for the debug connection can also be changed. This is done in the file "WM_Debug_config.ini". For details, see also the AT^SCFG command and its “Userware/DebugInterface” parameters described in [1]. Please keep in mind, that the IP address range 10.x.x.x is not supported for the configuration of debugging!
During installation of SMTK some new programs are installed for handling the debugging ses­sion in conjunction with the IDE. The installation routine of the SMTK doesn't change any con­figuration of an existing firewall on your PC.
In the case, that a firewall is installed on your PC and the local configured and used IP connec­tion (Dial-Up Network connection for debugging) is blocked or disturbed by this firewall, please configure the firewall or the Dial-Up Network connection manually to accept the new installed programs and the port or to use another port or contact your local PC administrator for help.